<?xml version="1.0" encoding="iso-8859-1" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content=
    "application/xhtml+xml; charset=iso-8859-1" />
    <title>
      VLC-3.0.8
    </title>
    <link rel="stylesheet" type="text/css" href="../stylesheets/lfs.css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.79.1" />
    <link rel="stylesheet" href="../stylesheets/lfs-print.css" type=
    "text/css" media="print" />
  </head>
  <body class="blfs" id="blfs-9.1">
    <div class="navheader">
      <h4>
        Beyond Linux<sup>�</sup> From Scratch <span class="phrase">(System
        V</span> Edition) - Version 9.1
      </h4>
      <h3>
        Chapter&nbsp;44.&nbsp;Video Utilities
      </h3>
      <ul>
        <li class="prev">
          <a accesskey="p" href="transcode.html" title=
          "Transcode-1.1.7">Prev</a>
          <p>
            Transcode-1.1.7
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="xine-ui.html" title=
          "xine-ui-0.99.12">Next</a>
          <p>
            xine-ui-0.99.12
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="videoutils.html" title=
          "Chapter&nbsp;44.&nbsp;Video Utilities">Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Beyond Linux� From Scratch     (System V Edition) - Version 9.1">Home</a>
        </li>
      </ul>
    </div>
    <div class="sect1" lang="en" xml:lang="en">
      <h1 class="sect1">
        <a id="vlc" name="vlc"></a>VLC-3.0.8
      </h1>
      <div class="package" lang="en" xml:lang="en">
        <h2 class="sect2">
          Introduction to VLC
        </h2>
        <p>
          <span class="application">VLC</span> is a media player, streamer,
          and encoder. It can play from many inputs, such as files, network
          streams, capture devices, desktops, or DVD, SVCD, VCD, and audio
          CD. It can use most audio and video codecs (MPEG 1/2/4, H264, VC-1,
          DivX, WMV, Vorbis, AC3, AAC, etc.), and it can also convert to
          different formats and/or send streams through the network.
        </p>
        <p>
          This package is known to build and work properly using an LFS-9.1
          platform.
        </p>
        <h3>
          Package Information
        </h3>
        <div class="itemizedlist">
          <ul class="compact">
            <li class="listitem">
              <p>
                Download (HTTP): <a class="ulink" href=
                "https://download.videolan.org/vlc/3.0.8/vlc-3.0.8.tar.xz">https://download.videolan.org/vlc/3.0.8/vlc-3.0.8.tar.xz</a>
              </p>
            </li>
            <li class="listitem">
              <p>
                Download MD5 sum: 744442ec0c145453ea1d257914c8072e
              </p>
            </li>
            <li class="listitem">
              <p>
                Download size: 25 MB
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated disk space required: 728 MB (add 13 MB for tests)
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated build time: 2.1 SBU (using parallelism=4; add 0.2
                SBU for tests)
              </p>
            </li>
          </ul>
        </div>
        <h3>
          VLC Dependencies
        </h3>
        <h4>
          Recommended
        </h4>
        <p class="recommended">
          <a class="xref" href="alsa-lib.html" title=
          "alsa-lib-1.2.1.2">alsa-lib-1.2.1.2</a>, <a class="xref" href=
          "ffmpeg.html" title="FFmpeg-4.2.2">FFmpeg-4.2.2</a>, <a class=
          "xref" href="liba52.html" title="Liba52-0.7.4">liba52-0.7.4</a>,
          <a class="xref" href="../general/libgcrypt.html" title=
          "libgcrypt-1.8.5">libgcrypt-1.8.5</a> <a class="xref" href=
          "libmad.html" title="libmad-0.15.1b">libmad-0.15.1b</a>, <a class=
          "xref" href="../general/lua.html" title="Lua-5.3.5">Lua-5.3.5</a>,
          and <a class="xref" href="../x/installing.html" title=
          "Chapter&nbsp;24.&nbsp;X Window System Environment">X Window
          System</a>,
        </p>
        <h4>
          Optional features and packages
        </h4>
        <p class="optional">
          <a class="xref" href="../general/dbus.html" title=
          "dbus-1.12.16">dbus-1.12.16</a> and <a class="xref" href=
          "../general/libssh2.html" title="libssh2-1.9.0">libssh2-1.9.0</a>
        </p>
        <h4>
          Optional input plugins
        </h4>
        <p class="optional">
          <a class="xref" href="libcddb.html" title=
          "libcddb-1.3.2">libcddb-1.3.2</a>, <a class="xref" href=
          "libdv.html" title="Libdv-1.0.0">libdv-1.0.0</a>, <a class="xref"
          href="libdvdcss.html" title="libdvdcss-1.4.2">libdvdcss-1.4.2</a>,
          <a class="xref" href="libdvdread.html" title=
          "Libdvdread-6.0.2">libdvdread-6.0.2</a>, <a class="xref" href=
          "libdvdnav.html" title="Libdvdnav-6.0.1">libdvdnav-6.0.1</a>,
          <a class="xref" href="../general/opencv.html" title=
          "opencv-4.2.0">opencv-4.2.0</a> (currently broken), <a class="xref"
          href="../basicnet/samba.html" title=
          "Samba-4.11.6">Samba-4.11.6</a>, <a class="xref" href=
          "v4l-utils.html" title="v4l-utils-1.18.0">v4l-utils-1.18.0</a>,
          <a class="ulink" href=
          "http://www.videolan.org/developers/libbluray.html">libbluray</a>,
          <a class="ulink" href=
          "http://sourceforge.net/projects/libdc1394/">libdc1394</a>,
          <a class="ulink" href=
          "https://github.com/libproxy/libproxy">libproxy</a>, <a class=
          "ulink" href="http://www.live555.com/">Live555</a>, and <a class=
          "ulink" href="http://www.gnu.org/software/vcdimager/">VCDImager</a>
          (requires <a class="xref" href="libcdio.html" title=
          "libcdio-2.1.0">libcdio-2.1.0</a>)
        </p>
        <h4>
          Optional mux/demux plugins
        </h4>
        <p class="optional">
          <a class="xref" href="libogg.html" title=
          "libogg-1.3.4">libogg-1.3.4</a>, <a class="ulink" href=
          "https://github.com/kode54/Game_Music_Emu">Game Music Emu</a>,
          <a class="ulink" href=
          "http://www.videolan.org/developers/libdvbpsi.html">libdvbpsi</a>,
          <a class="ulink" href=
          "http://downloads.xiph.org/releases/libshout/">libshout</a>,
          <a class="ulink" href=
          "http://dl.matroska.org/downloads/libmatroska/">libmatroska</a>
          (requires <a class="ulink" href=
          "http://dl.matroska.org/downloads/libebml/">libebml</a>), <a class=
          "ulink" href=
          "http://sourceforge.net/projects/modplug-xmms/">libmodplug</a>,
          <a class="ulink" href="http://www.musepack.net/">Musepack</a>, and
          <a class="ulink" href=
          "http://sourceforge.net/projects/sidplay2/">sidplay-libs</a>
        </p>
        <h4>
          Optional codec plugins
        </h4>
        <p class="optional">
          <a class="xref" href="faad2.html" title=
          "FAAD2-2.8.8">FAAD2-2.8.8</a>, <a class="xref" href="flac.html"
          title="FLAC-1.3.3">FLAC-1.3.3</a>, <a class="xref" href=
          "libass.html" title="libass-0.14.0">libass-0.14.0</a>, <a class=
          "xref" href="libmpeg2.html" title=
          "libmpeg2-0.5.1">libmpeg2-0.5.1</a>, <a class="xref" href=
          "../general/libpng.html" title="libpng-1.6.37">libpng-1.6.37</a>,
          <a class="xref" href="libtheora.html" title=
          "libtheora-1.1.1">libtheora-1.1.1</a>, <a class="xref" href=
          "../x/x7driver.html#libva" title="libva-2.6.1">libva-2.6.1</a>,
          <a class="xref" href="libvorbis.html" title=
          "libvorbis-1.3.6">libvorbis-1.3.6</a>, <a class="xref" href=
          "opus.html" title="Opus-1.3.1">Opus-1.3.1</a>, <a class="xref"
          href="speex.html" title="Speex-1.2.0">Speex-1.2.0</a>, <a class=
          "xref" href="x264.html" title="x264-20200218">x264-20200218</a>,
          <a class="ulink" href=
          "https://aomedia.googlesource.com/aom/">aom</a>, <a class="ulink"
          href="https://code.videolan.org/videolan/dav1d">dav1d</a>,
          <a class="ulink" href=
          "http://sourceforge.net/projects/dirac/">Dirac</a>, <a class=
          "ulink" href=
          "http://sourceforge.net/projects/fluidsynth/">FluidSynth</a>,
          <a class="ulink" href=
          "http://www.videolan.org/developers/libdca.html">libdca</a>,
          <a class="ulink" href=
          "http://code.google.com/p/libkate/">libkate</a>, <a class="ulink"
          href="http://www.khronos.org/openmax/">OpenMAX</a>, <a class=
          "ulink" href=
          "http://sourceforge.net/projects/schrodinger/">Schroedinger</a>,
          <a class="ulink" href=
          "https://sourceforge.net/p/soxr/wiki/Home/">SoX</a>, <a class=
          "ulink" href="http://wiki.xiph.org/Tremor">Tremor</a>, <a class=
          "ulink" href="http://www.twolame.org/">Twolame</a>, and <a class=
          "ulink" href="http://sourceforge.net/projects/zapping/">Zapping
          VBI</a>
        </p>
        <h4>
          Optional video plugins
        </h4>
        <p class="optional">
          <a class="xref" href="../general/aalib.html" title=
          "AAlib-1.4rc5">AAlib-1.4rc5</a>, <a class="xref" href=
          "../general/fontconfig.html" title=
          "Fontconfig-2.13.1">Fontconfig-2.13.1</a>, <a class="xref" href=
          "../general/freetype2.html" title=
          "FreeType-2.10.1">FreeType-2.10.1</a>, <a class="xref" href=
          "../general/fribidi.html" title="FriBidi-1.0.8">FriBidi-1.0.8</a>,
          <a class="xref" href="../general/librsvg.html" title=
          "librsvg-2.46.4">librsvg-2.46.4</a>, <a class="xref" href=
          "../x/x7driver.html#libvdpau" title=
          "libvdpau-1.3">libvdpau-1.3</a>, <a class="xref" href="sdl.html"
          title="SDL-1.2.15">SDL-1.2.15</a> (with <a class="ulink" href=
          "http://www.libsdl.org/projects/SDL_image/">SDL_image</a>), and
          <a class="ulink" href="http://caca.zoy.org/">libcaca</a>
        </p>
        <h4>
          Optional audio plugins
        </h4>
        <p class="optional">
          <a class="xref" href="pulseaudio.html" title=
          "PulseAudio-13.0">PulseAudio-13.0</a>, <a class="xref" href=
          "libsamplerate.html" title=
          "libsamplerate-0.1.9">libsamplerate-0.1.9</a>, and <a class="ulink"
          href="http://jackaudio.org/">JACK</a>
        </p>
        <h4>
          Optional interface plugins
        </h4>
        <p class="optional">
          <a class="xref" href="../x/qt5.html" title=
          "Qt-5.14.1">Qt-5.14.1</a> (required for the graphical user
          interface), <a class="ulink" href=
          "http://pkgbuild.com/~giovanni/libtar/">libtar</a>, and <a class=
          "ulink" href="http://www.lirc.org/">LIRC</a>
        </p>
        <h4>
          Optional visualisations and video filter plugins
        </h4>
        <p class="optional">
          <a class="ulink" href=
          "http://sourceforge.net/projects/goom/">Goom</a> and <a class=
          "ulink" href=
          "http://sourceforge.net/projects/projectm/">projectM</a>
        </p>
        <h4>
          Optional service discovery plugins
        </h4>
        <p class="optional">
          <a class="xref" href="../basicnet/avahi.html" title=
          "Avahi-0.7">Avahi-0.7</a>, <a class="ulink" href=
          "http://sourceforge.net/projects/libmtp/">libmtp</a> and <a class=
          "ulink" href="http://sourceforge.net/projects/pupnp/">libupnp</a>
        </p>
        <h4>
          Miscellaneous options
        </h4>
        <p class="optional">
          <a class="xref" href="../postlfs/gnutls.html" title=
          "GnuTLS-3.6.12">GnuTLS-3.6.12</a>, <a class="xref" href=
          "../x/libnotify.html" title="libnotify-0.7.8">libnotify-0.7.8</a>,
          <a class="xref" href="../general/libxml2.html" title=
          "libxml2-2.9.10">libxml2-2.9.10</a>, <a class="xref" href=
          "taglib.html" title="Taglib-1.11.1">taglib-1.11.1</a>, <a class=
          "xref" href="../xsoft/xdg-utils.html" title=
          "xdg-utils-1.1.3">xdg-utils-1.1.3</a> (runtime), and <a class=
          "ulink" href=
          "http://www.ambilight4pc.com/atmolight.html">AtmoLight</a>
        </p>
        <p class="usernotes">
          User Notes: <a class="ulink" href=
          "http://wiki.linuxfromscratch.org/blfs/wiki/vlc">http://wiki.linuxfromscratch.org/blfs/wiki/vlc</a>
        </p>
      </div>
      <div class="installation" lang="en" xml:lang="en">
        <h2 class="sect2">
          Installation of VLC
        </h2>
        <p>
          Install <span class="application">VLC</span> by running the
          following commands:
        </p>
        <pre class="userinput">
<kbd class=
"command">sed -i '/vlc_demux.h/a #define LUA_COMPAT_APIINTCASTS' modules/lua/vlc.h   &amp;&amp;
sed -i '/LIBSSH2_VERSION_NUM/s/10801/10900/' modules/access/sftp.c &amp;&amp;

BUILDCC=gcc ./configure --prefix=/usr    \
                        --disable-opencv \
                        --disable-vpx    &amp;&amp;

make</kbd>
</pre>
        <p>
          To test the results, issue: <span class="command"><strong>make
          check</strong></span>.
        </p>
        <p>
          Now, as the <code class="systemitem">root</code> user:
        </p>
        <pre class="root">
<kbd class="command">make docdir=/usr/share/doc/vlc-3.0.8 install</kbd>
</pre>
        <div class="admon note">
          <img alt="[Note]" src="../images/note.png" />
          <h3>
            Note
          </h3>
          <p>
            This package installs icon files into the <code class=
            "filename">/usr/share/icons/hicolor</code> hierarchy and desktop
            files into the <code class=
            "filename">/usr/share/applications</code> hierarchy. You can
            improve system performance and memory usage by updating
            <code class=
            "filename">/usr/share/icons/hicolor/index.theme</code> and
            <code class=
            "filename">/usr/share/applications/mimeinfo.cache</code>. To
            perform the update you must have <a class="xref" href=
            "../x/gtk2.html" title="GTK+-2.24.32">GTK+-2.24.32</a> or
            <a class="xref" href="../x/gtk3.html" title=
            "GTK+-3.24.13">GTK+-3.24.13</a> installed (for the icon cache)
            and <a class="xref" href="../general/desktop-file-utils.html"
            title="desktop-file-utils-0.24">desktop-file-utils-0.24</a> (for
            the desktop cache) and issue the following commands as the
            <code class="systemitem">root</code> user:
          </p>
          <pre class="userinput">
<kbd class=
"command">gtk-update-icon-cache -qtf /usr/share/icons/hicolor &amp;&amp;
update-desktop-database -q</kbd>
</pre>
        </div>
      </div>
      <div class="commands" lang="en" xml:lang="en">
        <h2 class="sect2">
          Command Explanations
        </h2>
        <p>
          <span class="command"><strong>sed ...
          modules/lua/...</strong></span>: This command allows building with
          the current version of <a class="xref" href="../general/lua.html"
          title="Lua-5.3.5">Lua-5.3.5</a>.
        </p>
        <p>
          <span class="command"><strong>sed ...
          modules/access/sftp.c</strong></span>: This command fixes building
          with <a class="xref" href="../general/libssh2.html" title=
          "libssh2-1.9.0">libssh2-1.9.0</a>.
        </p>
        <p>
          <em class="parameter"><code>--disable-opencv</code></em>: This
          switch is required to disable <span class=
          "application">opencv</span> which is not compatible with this
          version of <span class="application">vlc</span>.
        </p>
        <p>
          <em class="parameter"><code>--disable-vpx</code></em>: This switch
          is required to disable <span class="application">libvpx</span>. The
          latest version is not compatible with this version of <span class=
          "application">vlc</span>.
        </p>
        <p>
          <code class="option">--disable-lua</code>: Use this switch if you
          don't have <span class="application">Lua</span> installed.
        </p>
        <p>
          <code class="option">--disable-mad</code>: Use this switch if you
          don't have <span class="application">libmad</span> installed.
        </p>
        <p>
          <code class="option">--disable-avcodec --disable-swscale</code>:
          Use these switches if you don't have <span class=
          "application">FFmpeg</span> installed.
        </p>
        <p>
          <code class="option">--disable-a52</code>: Use this switch if you
          don't have <span class="application">liba52</span> installed.
        </p>
        <p>
          <code class="option">--disable-xcb</code>: Use this switch if you
          don't have <span class="application">X Window System</span>
          installed.
        </p>
        <p>
          <code class="option">--disable-alsa</code>: Use this switch if you
          don't have <span class="application">ALSA</span> installed.
        </p>
        <p>
          <code class="option">--disable-libgcrypt</code>: Use this switch if
          you don't have <span class="application">libgcrypt</span>
          installed.
        </p>
        <p>
          <code class="option">--disable-sftp</code>: The default is to build
          the sftp module if <a class="xref" href="../general/libssh2.html"
          title="libssh2-1.9.0">libssh2-1.9.0</a> is installed. Use this
          switch if you do not want to build this module.
        </p>
        <div class="admon note">
          <img alt="[Note]" src="../images/note.png" />
          <h3>
            Note
          </h3>
          <p>
            There are many options to <span class="application">VLC</span>'s
            <span class="command"><strong>configure</strong></span> command.
            Check the <span class="command"><strong>configure
            --help</strong></span> output for a complete list.
          </p>
        </div>
      </div>
      <div class="content" lang="en" xml:lang="en">
        <h2 class="sect2">
          Contents
        </h2>
        <div class="segmentedlist">
          <div class="seglistitem">
            <div class="seg">
              <strong class="segtitle">Installed Programs:</strong>
              <span class="segbody">cvlc, nvlc, qvlc, rvlc, svlc, vlc and
              vlc-wrapper</span>
            </div>
            <div class="seg">
              <strong class="segtitle">Installed Libraries:</strong>
              <span class="segbody">libvlccore.so, libvlc.so, and many
              plugins in /usr/lib/vlc/plugins</span>
            </div>
            <div class="seg">
              <strong class="segtitle">Installed Directories:</strong>
              <span class="segbody">/usr/{include,lib,share}/vlc and
              /usr/share/doc/vlc-3.0.8</span>
            </div>
          </div>
        </div>
        <div class="variablelist">
          <h3>
            Short Descriptions
          </h3>
          <table border="0" class="variablelist">
            <colgroup>
              <col align="left" valign="top" />
              <col />
            </colgroup>
            <tbody>
              <tr>
                <td>
                  <p>
                    <a id="cvlc" name="cvlc"></a><span class=
                    "term"><span class=
                    "command"><strong>cvlc</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a script to run VLC with the dummy interface.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="nvlc" name="nvlc"></a><span class=
                    "term"><span class=
                    "command"><strong>nvlc</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a script to run VLC with the ncurses interface.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="qvlc" name="qvlc"></a><span class=
                    "term"><span class=
                    "command"><strong>qvlc</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a script to run <span class="application">VLC</span>
                    with the <span class="application">Qt</span> interface.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="rvlc" name="rvlc"></a><span class=
                    "term"><span class=
                    "command"><strong>rvlc</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a script to run <span class="application">VLC</span>
                    with a command line interface.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="svlc" name="svlc"></a><span class=
                    "term"><span class=
                    "command"><strong>svlc</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a script to run <span class="application">VLC</span>
                    with the skins interface.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="vlc-prog" name="vlc-prog"></a><span class=
                    "term"><span class=
                    "command"><strong>vlc</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is the <span class="application">VLC</span> media player.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="vlc-wrapper" name="vlc-wrapper"></a><span class=
                    "term"><span class=
                    "command"><strong>vlc-wrapper</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a wrapper to drop privileges with <span class=
                    "application">VLC</span>.
                  </p>
                </td>
              </tr>
            </tbody>
          </table>
        </div>
      </div>
      <p class="updated">
        Last updated on 2020-02-19 16:31:22 -0800
      </p>
    </div>
    <div class="navfooter">
      <ul>
        <li class="prev">
          <a accesskey="p" href="transcode.html" title=
          "Transcode-1.1.7">Prev</a>
          <p>
            Transcode-1.1.7
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="xine-ui.html" title=
          "xine-ui-0.99.12">Next</a>
          <p>
            xine-ui-0.99.12
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="videoutils.html" title=
          "Chapter&nbsp;44.&nbsp;Video Utilities">Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Beyond Linux� From Scratch     (System V Edition) - Version 9.1">Home</a>
        </li>
      </ul>
    </div>
  </body>
</html>
